Skip to main content

Design Gallery - Merchant Setup Guide

๐Ÿ“– Overviewโ€‹

The Design Gallery feature allows you to showcase pre-made designs that customers can select and use on custom hats through Hat Lab. This guide will walk you through setting up and testing the feature in your Shopify admin.

๐ŸŽฏ What This Feature Doesโ€‹

For Your Customers:

  • Browse a gallery of pre-made designs
  • Preview designs in full-size before selecting
  • Select a design and bring it directly into Hat Lab
  • Use designs from pre-finished hat products on custom hats
  • See their selected design throughout the customization process

For Your Store:

  • Showcase your design library
  • Bridge pre-finished products to custom orders
  • Streamline the Hat Lab experience with pre-made options
  • Track design selections in orders

๐Ÿ“‹ Setup Instructionsโ€‹

Step 1: Create Design Storage (Metaobjects)โ€‹

Metaobjects allow you to store your designs in Shopify. You'll create two definitions: one for individual designs, and one for galleries.

A. Create "Design Item" Definitionโ€‹

This stores individual designs (the actual artwork/logos).

  1. Go to Shopify Admin โ†’ Settings โ†’ Metafields and metaobjects โ†’ Metaobject definitions

  2. Click "Add definition"

  3. Enter these settings:

    • Name: Design Item
    • Type: design_item
  4. Click "Add field" and create these fields:

    Field 1: Title

    • Type: Single line text
    • Name: title
    • Mark as Required

    Field 2: Image

    • Type: File
    • Name: image
    • Mark as Required
    • โ„น๏ธ This is the full-size design image

    Field 3: Thumbnail (Optional)

    • Type: File
    • Name: thumbnail
    • โ„น๏ธ Smaller version for grid view (uses main image if empty)

    Field 4: Description (Optional)

    • Type: Multi-line text
    • Name: description
    • โ„น๏ธ Additional details shown in preview
  5. Click "Save"

This groups multiple designs into a collection.

  1. Stay in Metaobject definitions and click "Add definition"

  2. Enter these settings:

    • Name: Design Gallery
    • Type: design_gallery
  3. Click "Add field" and create:

    Field: Designs

    • Type: List of entries
    • Name: designs
    • Reference type: Design Item
    • โ„น๏ธ You'll select which designs appear in this gallery
  4. Click "Save"

C. Add Design Reference to Productsโ€‹

This connects pre-finished hat products to their designs.

  1. Go to Settings โ†’ Metafields and metaobjects โ†’ Products

  2. Click "Add definition"

  3. Enter these settings:

    • Name: Design Reference
    • Namespace and key: custom.design_reference
    • Type: Metaobject reference (one entry)
    • Metaobject: Design Item
    • โ„น๏ธ This links a product to a specific design
  4. Click "Save"

Step 2: Add Your Designsโ€‹

Now you'll upload your actual design files and organize them into galleries.

A. Create Design Itemsโ€‹

Add each design individually:

  1. Go to Shopify Admin โ†’ Content โ†’ Metaobjects

  2. Select "Design Items" from the list

  3. Click "Add entry"

  4. Fill in the design details:

    Title: Give it a clear name (e.g., "Vintage Logo", "Classic Stripe")

    • Keep it under 30 characters
    • Use customer-friendly names

    Image: Upload the full-size design file

    • Recommended: 1200x1200px or larger
    • Use JPG or PNG format
    • This is what customers see in the lightbox preview

    Thumbnail: (Optional) Upload a smaller version

    • Recommended: 400x400px
    • If left empty, the main image will be used
    • Helps with page load speed

    Description: (Optional) Add design details

    • What makes this design special?
    • Any restrictions or best uses
    • Shows in the preview lightbox
  5. Click "Save"

  6. Repeat for each design you want to offer

๐Ÿ’ก Tip: Start with 5-10 designs to test the feature, then add more as needed.

Group your designs into a collection:

  1. Stay in Content โ†’ Metaobjects

  2. Select "Design Galleries"

  3. Click "Add entry"

  4. In the "Designs" field:

    • Click "Browse"
    • Select all the Design Items you want in this gallery
    • You can reorder them by dragging
  5. Click "Save"

๐Ÿ’ก Tip: You can create multiple galleries for different collections or seasons.

Create a page where customers can browse and select designs.

A. Create the Pageโ€‹

  1. Go to Shopify Admin โ†’ Online Store โ†’ Pages
  2. Click "Add page"
  3. Give it a title (e.g., "Design Gallery", "Choose Your Design", "Pre-Made Designs")
  4. Save the page (content will be added via theme customizer)
  1. In the page editor, click "Customize" (top right)
  2. In the theme editor, click "Add section"
  3. Select "Design Gallery"
  4. Configure the settings:

Content Settings:

  • Design gallery container: Select your gallery from Step 2B
  • Designs field name: Leave as designs (unless you renamed it)
  • Heading: e.g., "Choose Your Design"
  • Subheading: (Optional) Add context like "Pick a design to customize your hat"
  • Button text: Text on hover buttons (e.g., "Bring to Hat Lab", "Select Design")

Layout Settings:

  • Designs per row (desktop): How many designs show side-by-side (recommended: 3-4)
  • Designs per row (mobile): How many on phone screens (recommended: 1-2)
  • Gap between designs: Spacing (recommended: Medium)
  • Border radius: Rounded corners (optional, for modern look)

Empty State:

  • Message when empty: What shows if no designs exist (for testing)
  1. Click "Save" (top right)

๐Ÿ’ก Tip: Preview on mobile and desktop to ensure the layout looks good on all devices.

Step 4: Add Design Features to Products (Optional)โ€‹

You can add design selection directly to product pages in two ways:

Option A: Pre-Finished Hat Bridgeโ€‹

Let customers use a design from a pre-finished product on a custom hat.

1. Add the Block to Product Template

  1. Go to Online Store โ†’ Themes โ†’ Customize

  2. Navigate to Products โ†’ Default product (or your product template)

  3. In the product information section, click "Add block"

  4. Select "Use Design on Custom Hat"

  5. Configure settings:

    • Button text: "Use this design on a custom hat"
    • Button style: Primary, Secondary, or Outline
    • Show design preview: Toggle on (shows the design image)
    • Required product tag: (Optional) Enter pre-finished to only show on tagged products
  6. Position the block where you want it (drag to reorder)

  7. Click "Save"

2. Connect Designs to Products

For each pre-finished hat product:

  1. Go to Products in Shopify admin
  2. Open the pre-finished hat product
  3. Scroll to "Metafields" section
  4. Find "Design Reference"
  5. Click "Select entry" and choose the design for this product
  6. Click "Save"

Now when customers view this product, they'll see a button to use that design in Hat Lab.

Option B: Design Selector on Hat Lab Productsโ€‹

Let customers choose designs directly on custom hat product pages.

1. Add the Block

  1. Go to Online Store โ†’ Themes โ†’ Customize

  2. Navigate to your Hat Lab product template

  3. In the product information section, click "Add block"

  4. Select "Product Design Selector"

  5. Configure settings:

    Content:

    • Property key: Design (this is what appears in orders)
    • Heading: "Choose a Design"
    • Gallery container: Select your gallery
    • Designs field name: designs

    Display:

    • Show thumbnails: Toggle on
    • Selection mode:
      • Single (radio) - customer picks one design
      • Multiple (checkbox) - customer can pick several
    • Thumbnail size: Small, Medium, or Large

    Filters: (Optional)

    • Required product tag: Only show on products with this tag
  6. Click "Save"

Option C: Hide File Uploads When Design Selectedโ€‹

Automatically hide file upload options when a customer selects a design.

  1. In Theme Customizer, find your "Product File Upload" block
  2. Open the block settings
  3. Enable "Hide when design is selected"
  4. Click "Save"

Now the file upload will automatically hide when a design is chosen, and reappear if the design is removed.

๐Ÿ’ก Tip: You can use any combination of these options. Test each to see what works best for your store.


๐Ÿงช Testing Your Setupโ€‹

Test each feature to ensure everything works correctly for your customers.

Test the gallery displays correctly:

  1. Visit your design gallery page
  2. Check that:
    • โœ… All your designs appear in the grid
    • โœ… Design names show below each image
    • โœ… Grid looks good on desktop
    • โœ… Grid adjusts properly on mobile/tablet

Test the hover button:

  1. Hover your mouse over a design card (desktop only)
  2. Check that:
    • โœ… "Bring to Hat Lab" button appears
    • โœ… Card lifts slightly when hovering

Test selecting a design:

  1. Click the "Bring to Hat Lab" button on any design
  2. Check that:
    • โœ… You're redirected to Hat Lab (Step 1)
    • โœ… Design continues to next step (see Test 2)

Test 2: Design Lightbox Previewโ€‹

Test the preview popup:

  1. On the gallery page, click directly on a design card (not the button)
  2. Check that:
    • โœ… Large preview popup appears
    • โœ… Design shows full-size and clear
    • โœ… Design title appears
    • โœ… Description appears (if you added one)

Test closing the preview:

  1. Try each way to close:
    • โœ… Click the X button (top right)
    • โœ… Click outside the preview (on dark area)
    • โœ… Press ESC key on keyboard

Test selecting from preview:

  1. Open preview again
  2. Click "Select This Design" button
  3. Check that:
    • โœ… Preview closes
    • โœ… You're redirected to Hat Lab
    • โœ… Design is selected (see Test 3)

Test 3: Hat Lab with Selected Designโ€‹

Test design indicator appears:

  1. After selecting a design (from Tests 1 or 2), check Hat Lab Step 1
  2. Look for "Selected Design" box below the progress bar
  3. Check that:
    • โœ… Box appears with design thumbnail
    • โœ… Design name is shown
    • โœ… "Remove" button is present

Test design preview:

  1. Hover over the thumbnail
  2. Check that:
    • โœ… Larger preview appears as tooltip

Test lightbox from thumbnail:

  1. Click the thumbnail
  2. Check that:
    • โœ… Full lightbox opens with design
    • โœ… All lightbox features work (close, etc.)

Test removing design:

  1. Click the "Remove" button
  2. Check that:
    • โœ… Selected design box disappears
    • โœ… You can continue Hat Lab without a design

Test design persists through steps:

  1. Select a design again

  2. Complete Hat Lab Step 1 (choose style/color)

  3. Move to Step 2 (add-ons)

  4. Check that:

    • โœ… Selected design box still shows
  5. Move to Step 3 (product page)

  6. Check that:

    • โœ… Selected design box still shows
    • โœ… File upload is hidden (if you enabled that setting)

Test design in cart:

  1. Add the hat to cart
  2. View your cart
  3. Check that:
    • โœ… Design name appears under the product
    • โœ… Listed as "Design: [Design Name]"

Test 4: Pre-Finished Hat Bridgeโ€‹

Test the block appears:

  1. Go to a pre-finished hat product (that you connected a design to)
  2. Check that:
    • โœ… "Use this design on a custom hat" block appears
    • โœ… Design preview shows (if you enabled it)
    • โœ… Button looks correct (right style/color)

Test the bridge works:

  1. Click the button
  2. Check that:
    • โœ… You're redirected to Hat Lab Step 1
    • โœ… Design from the product is now selected
    • โœ… Selected design box appears
    • โœ… You can proceed through Hat Lab normally

Test 5: Product Design Selector Blockโ€‹

Test the selector displays:

  1. Go to a product with the design selector block
  2. Check that:
    • โœ… Block heading appears
    • โœ… Design thumbnails show in grid
    • โœ… All designs from your gallery appear

Test design preview:

  1. Click on a design thumbnail
  2. Check that:
    • โœ… Preview lightbox opens
    • โœ… Full design shows clearly
    • โœ… You can close the preview

Test selecting design:

  1. If using radio buttons (single):

    • โœ… Click a design to select it
    • โœ… Only one can be selected at a time
  2. If using checkboxes (multiple):

    • โœ… Click designs to check them
    • โœ… Multiple can be selected
    • โœ… Click again to uncheck

Test in cart:

  1. Select one or more designs
  2. Add product to cart
  3. View cart
  4. Check that:
    • โœ… Design name(s) appear under product
    • โœ… All selected designs are listed

Test 6: File Upload Hiding (If Enabled)โ€‹

Test upload visibility:

  1. Go to product page with both:

    • File upload block
    • Design selector or selected design
  2. Initially check:

    • โœ… File upload block is visible
  3. Select a design

  4. Check that:

    • โœ… File upload block disappears
    • โœ… Page layout adjusts smoothly
  5. Remove the design

  6. Check that:

    • โœ… File upload block reappears
    • โœ… Upload still works normally

Test 7: Mobile Experienceโ€‹

Repeat Tests 1-6 on a mobile device or in mobile browser mode:

  • โœ… Gallery looks good and is easy to navigate
  • โœ… Buttons are easy to tap
  • โœ… Lightbox works on touch screens
  • โœ… Selected design box displays properly
  • โœ… Everything is readable at small screen sizes

Test 8: Order Verificationโ€‹

Place a test order:

  1. Complete the entire flow with a design selected
  2. Place order (use test mode)
  3. View order in Shopify admin
  4. Check that:
    • โœ… Design appears in line item properties
    • โœ… Design name is clear and readable
    • โœ… You can see which design the customer selected

๐ŸŽจ Customization Optionsโ€‹

All blocks and sections have settings you can adjust in the theme customizer. Here's what you can control:

Access these in Theme Customizer when editing the Design Gallery section:

Content:

  • Heading text
  • Subheading text
  • Button text (appears on hover)
  • Empty state message

Layout:

  • Designs per row on desktop (1-6)
  • Designs per row on mobile (1-3)
  • Gap between design cards
  • Section padding

Style:

  • Border radius (rounded corners)
  • Hover effect intensity
  • Button style
  • Card shadow

Design Selector Block Settingsโ€‹

Access these when editing the Product Design Selector block:

Content:

  • Block heading
  • Property name (appears in orders)
  • Help text

Gallery:

  • Which gallery to pull designs from
  • Field name (usually designs)

Display:

  • Show/hide thumbnails
  • Thumbnail size (small, medium, large)
  • Grid columns
  • Gap between thumbnails

Selection:

  • Single selection (radio buttons)
  • Multiple selection (checkboxes)

Filters:

  • Only show on products with specific tag
  • Hide if another property is selected

Pre-Finished Hat Block Settingsโ€‹

Access these when editing the Use Design on Custom Hat block:

Button:

  • Button text
  • Button style (primary, secondary, outline)
  • Button size
  • Show icon

Preview:

  • Show/hide design image
  • Image size
  • Image position (above/beside button)

Behavior:

  • Where to redirect (Hat Lab step)
  • Animation style

Filters:

  • Only show on products with specific tag

๐Ÿ”„ Customer Journeysโ€‹

Understanding how customers experience this feature:

The Discovery Path

  1. Customer lands on your Design Gallery page
  2. Browses available designs
  3. Hovers over a design they like
  4. Clicks "Bring to Hat Lab" button
  5. Arrives at Hat Lab Step 1 with design already selected
  6. Sees their selected design in a box below the progress bar
  7. Completes Hat Lab (style โ†’ add-ons โ†’ product selection)
  8. Selected design follows them through all steps
  9. Adds to cart with design attached
  10. Design appears in order details

Best for: Customers who want to start with the design and then customize the hat around it.

Journey 2: Start with Pre-Finished Hatโ€‹

The Bridge Path

  1. Customer finds a pre-finished hat they like
  2. Wants that design but on a different hat style
  3. Sees "Use this design on a custom hat" button
  4. Clicks button
  5. Arrives at Hat Lab with the design from that product
  6. Customizes a hat with that design
  7. Adds to cart

Best for: Converting pre-finished product browsers into custom orders with higher margins.

Journey 3: Add Design During Customizationโ€‹

The Direct Selection Path

  1. Customer is already on a Hat Lab product page
  2. Sees the design selector block
  3. Clicks thumbnails to preview designs
  4. Selects one (or more, if checkboxes enabled)
  5. Design(s) added as properties
  6. File upload disappears (if that setting is on)
  7. Adds to cart

Best for: Customers who've already decided on a hat but want to add a design last minute.

๐Ÿ› Troubleshootingโ€‹

Common issues and how to fix them:

What's wrong: The gallery can't find your designs.

How to fix:

  1. Go to Content โ†’ Metaobjects โ†’ Design Items
    • Make sure you've created at least one design
  2. Go to Content โ†’ Metaobjects โ†’ Design Galleries
    • Open your gallery
    • Make sure designs are selected in the "designs" field
  3. In Theme Customizer, check the gallery section settings:
    • Verify the correct gallery is selected
    • Make sure "Designs field name" is set to designs
  4. Save and refresh the page

Selected Design Box Doesn't Appear in Hat Labโ€‹

What's wrong: Design isn't being saved when selected.

How to fix:

  1. Try selecting the design again
  2. Make sure you clicked the "Bring to Hat Lab" button or "Select This Design" button
  3. Check that you're redirected to Hat Lab after clicking
  4. Try in a different browser (Firefox, Chrome, Safari)
  5. Try in private/incognito mode
  6. If still not working, contact your developer

File Upload Still Shows When Design Selectedโ€‹

What's wrong: The hiding feature isn't enabled.

How to fix:

  1. Go to Theme Customizer
  2. Navigate to your product page with file upload
  3. Find the "Product File Upload" block
  4. Open its settings
  5. Look for "Hide when design is selected" toggle
  6. Turn it ON
  7. Click Save
  8. Test again

Pre-Finished Hat Button Not Showingโ€‹

What's wrong: The product isn't connected to a design.

How to fix:

  1. Go to Products in Shopify admin
  2. Open the pre-finished hat product
  3. Scroll down to "Metafields" section
  4. Find "Design Reference"
  5. Click "Select entry"
  6. Choose the design for this product
  7. Click "Save" at the top
  8. Refresh the product page

If you still don't see the button:

  1. Go to Theme Customizer
  2. View the product page
  3. Make sure the "Use Design on Custom Hat" block is added
  4. Check if there's a "Required product tag" setting
  5. If yes, make sure your product has that tag

Preview Lightbox Won't Openโ€‹

What's wrong: Something is preventing the popup from appearing.

How to fix:

  1. Try clicking directly on the design card (not the button)
  2. Disable any browser extensions that block popups
  3. Try in a different browser
  4. Try on a different device
  5. Check if the issue happens on all designs or just one
    • If just one, that design's image might be corrupted

Design Not Appearing in Cart or Ordersโ€‹

What's wrong: Design isn't being added as a property.

How to fix:

  1. Make sure you see the "Selected Design" box in Hat Lab before adding to cart
  2. Check that the design name shows when viewing your cart
  3. If using the design selector block:
    • Make sure you actually selected/checked a design
    • Look for a checkmark or radio button selection
  4. Try the complete flow again from the beginning

Changes Not Showing Upโ€‹

What's wrong: Your browser is showing a cached (old) version.

How to fix:

  1. Hard refresh the page:
    • Windows: Ctrl + Shift + R
    • Mac: Command + Shift + R
  2. Or clear your browser cache:
    • Go to browser settings
    • Find "Clear browsing data"
    • Select "Cached images and files"
    • Clear data
  3. Try in private/incognito mode
  4. Try a different browser

๐Ÿ’ก Best Practicesโ€‹

Follow these tips for the best customer experience:

Design Imagesโ€‹

File Formats:

  • Use PNG for designs with transparency
  • Use JPG for designs with solid backgrounds
  • Keep file sizes under 500KB for fast loading

Image Sizes:

  • Thumbnails: 400x400px minimum
  • Full images: 1200x1200px or larger
  • Use square images (same width and height) for best results
  • Images will be cropped to squares if they're not

Image Quality:

  • Use high-resolution images (at least 72 DPI, 150 DPI better)
  • Avoid blurry or pixelated designs
  • Make sure designs are centered in the image
  • Test how they look at both thumbnail and full size

Design Namesโ€‹

Keep Them Clear:

  • Under 30 characters works best
  • Use customer-friendly language
  • Example: "Vintage Logo" not "logo_vintage_v2_final"

Be Descriptive:

  • Help customers understand what they're getting
  • "Classic Stripe Pattern" is better than "Design 1"
  • Include style hints: "Modern Geometric", "Retro Badge"

Stay Consistent:

  • Use a naming system across all designs
  • If you use categories, put them first: "Vintage: Eagle Logo"
  • This helps you manage many designs

Start Small:

  • Launch with 10-15 of your best designs
  • See which ones customers prefer
  • Add more based on demand

Create Multiple Galleries:

  • Sports designs gallery
  • Vintage designs gallery
  • Seasonal designs gallery
  • Use different galleries on different pages

Group Related Designs:

  • Keep similar styles together
  • Makes browsing easier
  • Helps customers find what they want faster

Update Regularly:

  • Add new designs monthly or seasonally
  • Remove unpopular designs
  • Feature best-sellers at the top (reorder in metaobject)

Product Setupโ€‹

Use Consistent Tags:

  • Pick a tag system and stick with it
  • Examples: "pre-finished", "hat-lab-product", "custom"
  • Tag all relevant products the same way
  • Document your tags somewhere

Pre-Finished Products:

  • Always connect the design via metafield
  • Use high-quality product photos
  • Make the bridge button prominent
  • Test each product's flow

Design Selector Placement:

  • Put it near the top of product page
  • Above or near the "Add to Cart" button
  • Make it obvious with a clear heading

Customer Communicationโ€‹

Set Expectations:

  • Show example of what customized hat looks like
  • Explain any design limitations (size, placement, colors)
  • Clarify production time for custom orders

Help Text:

  • Add descriptions to complex designs
  • Explain if design works better on certain styles
  • Note any size or color restrictions

Gallery Page Content:

  • Add intro text explaining the process
  • Link to Hat Lab page
  • Include example finished products
  • Answer common questions

Testing Routineโ€‹

After Adding New Designs:

  1. View gallery page - designs show correctly?
  2. Click design - preview works?
  3. Select design - flows to Hat Lab?
  4. Complete order - design shows in cart?

After Connecting Pre-Finished Products:

  1. View product - button appears?
  2. Click button - redirects correctly?
  3. Design shows in Hat Lab?
  4. Test complete purchase

Regular Checks:

  • Test on mobile monthly
  • Try a customer order yourself quarterly
  • Check that all links work
  • Verify images still load fast

Organization Tipsโ€‹

Document Your Setup:

  • Keep a list of which galleries contain which designs
  • Note which products have design references
  • Track which tags you're using and why

Backup Your Work:

  • Take screenshots of metaobject setups
  • Export design files and keep originals
  • Save theme customizer settings

Plan for Growth:

  • Start with a naming system that scales
  • Use categories if you plan to have many designs
  • Consider how you'll organize 50+ designs

Seasonal Strategyโ€‹

Plan Ahead:

  • Create holiday designs early
  • Schedule when to add/remove seasonal designs
  • Have year-round designs that always work

Gallery Updates:

  • Create seasonal galleries
  • Switch which gallery is linked on pages
  • Or add multiple gallery sections to one page

Archive Old Designs:

  • Don't delete design items (orders may reference them)
  • Create an "Archive" gallery
  • Remove from active galleries when out of season

โ“ Frequently Asked Questionsโ€‹

Can I have multiple design galleries?โ€‹

Yes! Create as many gallery metaobjects as you want. Use different galleries:

  • On different pages
  • For different product types
  • For different seasons or collections

Just create a new "Design Gallery" metaobject entry and select different designs for each.

Will this affect my existing Hat Lab?โ€‹

No! Your Hat Lab continues to work exactly as before. The design features are completely optional:

  • Hat Lab works without any design selected
  • Customers can skip design selection
  • All existing features remain unchanged

Can customers upload their own designs AND select pre-made ones?โ€‹

Yes, customers can:

  • Upload their own file (if you have file upload blocks)
  • Select a pre-made design (if you have design selector blocks)
  • Do both (they'll see both in their order)

OR you can enable "Hide file upload when design selected" to make it one or the other.

Don't delete the Design Item - orders may reference it.

Instead:

  1. Go to Content โ†’ Metaobjects โ†’ Design Galleries
  2. Open your gallery
  3. In the "designs" field, deselect that design
  4. Save

The design still exists but won't show in the gallery.

Can I charge extra for premium designs?โ€‹

Not directly through this feature. The design is saved as a line item property (text), not a product.

Workarounds:

  1. Create separate products with different prices for premium designs
  2. Use a custom pricing app that reads line item properties
  3. Manually adjust orders with premium designs

What happens if I change a design's image later?โ€‹

If you replace the image in a Design Item:

  • New image shows in gallery immediately
  • Existing orders still reference the old image URL
  • Consider creating a new Design Item for major changes

Can customers see their selected design in the cart?โ€‹

Yes! The design name appears under the product in the cart as "Design: [Name]". The thumbnail doesn't show, just the name.

How do I organize many designs?โ€‹

Strategies:

  1. Multiple galleries - Group by theme/style
  2. Clear naming - Use prefixes like "Vintage: Logo 1"
  3. Regular pruning - Remove unpopular designs
  4. Multiple pages - Different gallery pages for different types

Do designs show up on the product page image?โ€‹

No, designs don't automatically appear on hat mockups. The "Selected Design" box shows the design separately.

If you want mockups with designs applied, you'll need:

  • Pre-finished products with the design already on the hat in photos
  • Custom mockup generation (requires developer)

Yes, but manually:

  1. Go to Orders in Shopify
  2. Export orders
  3. Look at line item properties
  4. Count how many times each design appears

Or use an analytics app that can read line item properties.

What file formats work for design images?โ€‹

  • PNG (best for transparent backgrounds)
  • JPG (best for photos/solid backgrounds)
  • GIF (works but not recommended)
  • SVG (not supported - convert to PNG first)

๐Ÿ“ž Getting Helpโ€‹

If you encounter issues not covered in this guide:

Before Contacting Support:โ€‹

  1. โœ… Work through the troubleshooting section above
  2. โœ… Verify all setup steps were completed
  3. โœ… Test in incognito/private browsing mode
  4. โœ… Try a different browser
  5. โœ… Check that all theme customizer changes were saved
  6. โœ… Make sure metaobjects are published (not draft)

When Contacting Support:โ€‹

Include this information:

  • Which flow you're testing (gallery, pre-finished, or selector)
  • Exact steps you took
  • What you expected to happen
  • What actually happened
  • Browser and device you're using
  • Screenshots if possible

Remember:โ€‹

This feature is completely optional and doesn't affect your existing Hat Lab. If something isn't working, you can:

  • Remove the blocks from products
  • Remove the gallery section from pages
  • Everything else continues to work normally

๐ŸŽ‰ Summaryโ€‹

You now have a complete design gallery system that lets customers:

  • โœ… Browse beautiful design galleries
  • โœ… Preview designs before selecting
  • โœ… Select designs that flow through Hat Lab
  • โœ… Use designs from pre-finished products on custom hats
  • โœ… See their selected design throughout the customization process
  • โœ… Complete orders with designs tracked in line item properties

What This Means For Your Business:โ€‹

Increased Sales:

  • Customers can easily choose professional designs
  • Bridges lower-cost pre-finished products to higher-margin custom orders
  • Streamlines the ordering process

Better Customer Experience:

  • Visual design browsing
  • Clear design selection
  • Design persists through entire flow
  • No confusion about what's selected

Easy Management:

  • Add/remove designs through Shopify admin
  • No coding required
  • Organize with galleries
  • Track in orders

Safe Implementation:

  • Doesn't affect existing functionality
  • Can be enabled/disabled anytime
  • Optional for customers
  • Falls back gracefully if not configured

๐Ÿš€ Next Stepsโ€‹

  1. Start Small: Set up 5-10 designs to test
  2. Test Thoroughly: Work through all the test scenarios
  3. Get Feedback: Have team members test the flow
  4. Launch: Start promoting your design gallery
  5. Monitor: Track which designs are popular
  6. Expand: Add more designs based on customer preferences

Happy selling! ๐ŸŽจ